home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr49 / 134_01.zip / -README.DOC < prev    next >
Text File  |  1993-06-12  |  4KB  |  135 lines

  1.  
  2.  
  3.  
  4. BDS 'C' Users' Group                        Compiler Utilities II
  5.  
  6.  
  7.  
  8.      ____                                                                NOTE: Certain of the programs on this disc are copyright (c) 
  9. 1983 by Kevin Kenny.  They have been released to the Users' Group 
  10.                                 ____     for non-commercial distribution only.  
  11.  
  12.      This  disc  contains  the  source  code for several programs
  13. which provide enhancements to the BDS 'C' environment.   Most  of
  14. these  programs  extend the capabilities of the compiler, in much
  15. the same spirit  as  the  very  successful  "Compiler  Utilities"
  16. disc.  
  17.  
  18.      Full  documentation is provided in machine-readable form for
  19. the programs.  All of the documentation files  are  intended  for
  20. processing  by the NRO text formatter, available as "Utilities V"
  21. from the Users' Group.  The program documentation  is  mostly  in
  22. the  form  of  "manual  pages"  which  follow  Stephen Browning's
  23. recommended style.  
  24.  
  25.      Installation instructions for  all  the  programs  are  also
  26. provided.   The  file  INSTALL.NRO  is  an  NRO  source for these
  27. directions.   
  28.  
  29.      The file -CATALOG.DOC is a list of the files provided,  with
  30. a short  description  of  each.  The following programs appear on
  31. this disc: 
  32.  
  33. _____    CASM2: 
  34.  
  35.      This program provides a replacement for CASM, the CRL-format 
  36. ASM preprocessor supplied with BDS 'C'. It has been  enhanced  to
  37. allow   access   to   the   external   variable   area  from  the
  38. assembly-language  code,  to  permit  underscores  as   part   of
  39. identifiers  (transliterating  them  to  'Q's  so  that ASM won't
  40. complain), and to handle relocation directives under  conditional
  41. assembly.   The  usage  of  CASM2  is exactly the same as that of
  42. CASM, so no documentation file has been supplied.  
  43.  
  44. _______    CMDUTIL: 
  45.  
  46.      This is a collection  of  subroutines  intended  mainly  for
  47. processing  the  argc and argv passed to the main program in 'C'.
  48. It provides a common  processing  for  option  abbreviations  and
  49. keyword  values,  and  a  common  procedure  to  display  command
  50. syntax.  It also includes an 'initv' procedure that is similar to 
  51. 'initw' but can handle octal, hex, and symbolic constants as well 
  52. as decimal numbers.  
  53.  
  54. ____    CORO: 
  55.  
  56.      This  is  a  subroutine   library   for   the   support   of
  57. 'coroutines',    a   way   to   simulate   multi-tasking   on   a
  58. single-threaded machine.  A verbose description of coroutines and 
  59. how they operate is in the file CORODOC.NRO; the specifics of the 
  60. package are described in CORO.NRO.  
  61.  
  62.  
  63. -README.DOC                    -1-               15 November 1983
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. BDS 'C' Users' Group                        Compiler Utilities II
  71.  
  72.  
  73. ________                                             CPROFILE: (Requires BDS 'C' release 1.50 or later) 
  74.  
  75.      This is a "profiler" for BDS 'C' programs.   For  each  line
  76. in  a  target program, it lists the number of times that line was
  77. executed on a particular run.  This  information  is  useful  for
  78. debugging and in performance analysis.  
  79.  
  80. ____                                             CTOA: (Requires BDS 'C' release 1.50 or later) 
  81.  
  82.      This is a disassembler for BDS 'C' object code.  It produces 
  83. a source file acceptable to CASM2 which generates the same object 
  84. program that a 'C' source did.  It is useful in understanding how 
  85. the compiler  operates.   It may also be used (God forbid!) to ge
  86. assembly language source for modification or transport to another 
  87. environment.  
  88.  
  89. ____    DIFF: 
  90.  
  91.      This is a program to compare  two  text  files  and  give  a
  92. listing of   their   differences.    It  handles  insertions  and
  93. deletions correctly, so can be used with  files  such  as  source
  94. programs  to  determine  the  changes  made  between    different
  95. versions.  
  96.  
  97. ______    GENREL: 
  98.  
  99.      This is a utility program that extracts relocation data from 
  100. a function on a .CRL file.   It  is  used  as  part  of  building
  101. CPROFILE,  to  enable  the run-time supervisor to be relocated to
  102. high memory.  
  103.  
  104. _____    RETAB: 
  105.  
  106.      This is a sample  program  to  illustrate  the  use  of  the
  107. coroutine package.    See  CORODOC.NRO  for  a description of its
  108. use.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. -README.DOC                    -2-               15 November 1983
  130.  
  131.  
  132.  
  133. 
  134. program that a 'C' source did.  It is useful in understanding how 
  135. the compiler  ope